home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / WHAT2.ZIP / WHAT.DOC < prev   
Encoding:
Text File  |  1986-04-28  |  5.2 KB  |  108 lines
  1.                                       WHAT.COM
  2.  
  3.                       V1.3  11/21/1985    Written By Kevin Ross
  4.  
  5.  
  6.          WHAT.COM is a handy little program that keeps little notes about
  7.          files on your system.  I am an avid collector of programs, and I
  8.          download alot of files from various BBS's.  If you are like me, you
  9.          have many files that you can't remeber downloading, or what they do.
  10.          That is where WHAT.COM comes in handy.  When you are finished
  11.          downloading a program, and back at the DOS prompt, you can write a
  12.          one line description of the file.  This comes in real handy when you
  13.          are looking at your hard disk directory three months later, and
  14.          can't remember what CRASH.COM does.  Thats one of those file names
  15.          that you don't dare try, without knowing exactly what it will do.
  16.          Using WHAT.COM, you will be able to remind yourself with a quick
  17.          little note.
  18.  
  19.          WHAT.COM is most useful for those with fixed drives, though it
  20.          should work just fine with floppy drives.  WHAT.COM creates a file
  21.          in the root directory called WHAT.DAT.  This is just a sequential
  22.          file containing the data for the program.  Each entry starts in the
  23.          first column with the filename.  It must be in uppercase letters.
  24.          WHAT.COM formats the file so it can be printed neatly, with columns
  25.          for the filenames, and descriptions.  Descriptions can be up to 60
  26.          characters long.  That should be more than enough for a quick
  27.          reminder of what a program does.
  28.  
  29.          SETTING UP WHAT.COM
  30.          -------------------
  31.          First, you should initialize the WHAT.DAT file.  This is done by
  32.          giving the command:
  33.                                  WHAT OPEN
  34.  
  35.          You will be asked if you want to create the file.  If you answer
  36.          'y', a new WHAT.DAT file will be created.  If there is already a
  37.          WHAT.DAT file, it will be overwritten, and all the data will be
  38.          lost.  You should only use this command once.
  39.  
  40.          (** WARNING: WHAT.DAT SHOULD NOT BE EDITED WITH A TEXT PROCESSER.  I
  41.          HAVE TRIED THIS, WITH SEVERAL EDITORS AND IT BECOMES IMPOSSIBLE TO
  42.          ADD NEW DATA TO THE FILE.  I SUSPECT IT HAS SOMETHING TO DO WITH THE
  43.          WAY THE TURBO-PASCAL APPEND COMMAND WORKS.  I HAVE HAD SUCCESS
  44.          SORTING THE FILE WITH THE DOS SORT FILTER, IF YOU WOULD LIKE TO SORT
  45.          THE FILE FOR PRINTING A HARD COPY. **)
  46.  
  47.          Next, you can start entering your program information.  This is done
  48.          by giving the command:
  49.                                  WHAT NEW filename.ext
  50.  
  51.          You will be asked to enter a 60 character description of the file.
  52.          Enter anything you like.  WHAT.COM will automatically include the
  53.          name of the file, so you don't have to re-enter it.  (Hint: Enter
  54.          only facts about the program, just enough so you will know what the
  55.          file does, and perhaps how to get help with the program.)  When you
  56.          are done, press enter, and WHAT.COM will ask if this is correct.
  57.          You can enter 'y' if it is, and the data will be saved to the file.
  58.          If you enter 'n', WHAT.COM will ask for another description of the
  59.          file.  If you enter 'q', WHAT.COM will stop, and the description
  60.          will be lost.
  61.  
  62.  
  63.  
  64.                                     WHAT  page 2
  65.  
  66.  
  67.          To find out WHAT a file IS, you enter the command:
  68.  
  69.                                  WHAT IS filename.ext
  70.  
  71.          WHAT.COM will then search the DATA file for matching filenames.  If
  72.          WHAT.COM finds a filename that matches, it will print the
  73.          description on the screen, then look for another match.  If it does
  74.          not find the filename, it will tell you that the file was not found.
  75.          WHAT searches by comparing the characters that were entered at the
  76.          keyboard, with the first characters on each line of the data file.
  77.          If you enter:
  78.                                  WHAT IS PROGRAM.COM
  79.  
  80.          WHAT will output the description for PROGRAM.COM.
  81.  
  82.          If you enter:              WHAT IS PROG
  83.  
  84.          WHAT will output descriptions of all files starting with PROG.
  85.          There might be a PROG.COM, or a PROGA.COM, or PROGRAM.COM.  It will
  86.          match the first characters on the data line with the filename.  You
  87.          could enter:
  88.                                       WHAT IS Q
  89.  
  90.          and all descriptions of files starting with Q would be written to
  91.          the screen.
  92.  
  93.          The last command you can give WHAT.COM is the print command.  This
  94.          will send the contents of the WHAT.DAT file to the printer.  You
  95.          might find it useful to have a printed copy of WHAT.DAT, in case you
  96.          want to browse through the files.
  97.  
  98.          WHAT.DAT can be sorted with the DOS utility SORT.  Best way to use
  99.          it is to give the command:
  100.  
  101.                              SORT < WHAT.DAT >WHAT1.DAT
  102.  
  103.          then rename WHAT1.DAT to WHAT.DAT.
  104.  
  105.          This will sort the file WHAT.DAT, then save the sorted list back in
  106.          WHAT.DAT.  This way, when you print the WHAT.DAT file, it will be in
  107.          some sort of order.
  108.